home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir26 / epi601_1.zip / README < prev    next >
Text File  |  1994-08-22  |  38KB  |  872 lines
  1. README                                                 August 22, 1994
  2.  
  3.                What's New in Epi Info, Version 6.01
  4.  
  5.  
  6. Epi Info, Version 6.00, was released on May 27, 1994.  Since then,
  7. as expected, helpful users have identified a number of problems
  8. to be fixed.  Version 6.01 was released during the week of
  9. of August 22, and is available via ftp on the Internet and from
  10. USD, Inc.
  11.  
  12. Some of the changes being made include:
  13.  
  14. Version 6.01 contains revisions that remove bugs discovered
  15. in Version 6.00, as follows:
  16.    1. Installation has been changed to allow custom installation
  17.       for those who wish to install Epi Info in directories that
  18.       are not directly subordinate to the root directory.
  19.       To install Epi Info, type INSTALL as usual and then follow
  20.       directions.
  21.  
  22.       For those who wish to use the installation program directly
  23.       without the extra guidance of the program file INSTALL.EXE
  24.       that precedes it, the main installation program has been
  25.       renamed to INSTALL6.EXE.  INSTALL6 creates directories
  26.       subordinate to the CURRENT directory of the drive you declare
  27.       as the DESTINATION drive.  If the current directory of C: is
  28.       C:\SOFTWARE, for example, declaring C: as the target drive
  29.       for installation will create C:\SOFTWARE\EPI6 and C:\SOFTWARE\NETSS.
  30.       INSTALL.EXE assures that you are logged to the desired directory
  31.       and you do not need to worry about the details if you use INSTALL.EXE.
  32.       If you choose to do a custom installation, with \EPI6 and \NETSS
  33.       created as subdirectories of a directory other than the root
  34.       directory, you must set a DOS environment variable called EIDIR
  35.       to the name of the parent disk and directory so that Epi Info
  36.       can find necessary text and data files.  The statement
  37.       SET EIDIR = (Drive:\Parent directory) would be inserted in
  38.       your AUTOEXEC.BAT file.  SET EIDIR = C:\APPS, for example,
  39.       is necessary if Epi Info is installed in C:\APPS\EPI6.
  40.  
  41.    2. In ENTER, after a search for a record, if the user chooses not
  42.        to edit the record found, the record was not reset to the
  43.        end of the file, and a user might inadvertently overwrite
  44.        the old record.  A message to users on a network informing
  45.        them about competition for a file has been removed in 6.01,
  46.        as the situation is resolved automatically.  Difficulties
  47.        in automatic incrementing of <IDNUM> fields on a network
  48.        have been resolved.
  49.  
  50.    3. EPED now imports European characters that are also in the
  51.        IBM DOS character set from WordPerfect files.  The dialog
  52.        box that appears with a multiple Find/Replace now moves
  53.        out of the way to avoid occasionally hiding the item found.
  54.  
  55.    4. In ANALYSIS:
  56.        A BUG THAT GAVE INCORRECT NUMERIC RESULTS IN TABLES OR
  57.         FREQUENCIES WITH FILES CONTAINING MORE THAN 524,288
  58.         RECORDS HAS BEEN CORRECTED.
  59.        IN VERSION 6.00, ON COMPUTERS USING CERTAIN DOS CODEPAGES
  60.         AND COUNTRY CODES, OTHER THAN THE STANDARD IBM CODEPAGE
  61.         FOR THE U.S., MISSING VALUES AND NEGATIVE VALUES IN YES/NO
  62.         FIELDS ARE LUMPED TOGETHER, LEADING TO INCORRECT RESULTS,
  63.         IF SET IGNORE IS OFF.  The country codes for which this
  64.         occurs are:
  65.              Belgian 032
  66.              Latin American 003
  67.              Spanish 034
  68.              Switzerland 041
  69.         Country codes are set in the COUNTRY command in the CONFIG.SYS
  70.         file, usually in the root directory of the disk from which
  71.         DOS is loaded.  A typical COUNTRY command looks like this:
  72.            COUNTRY=033,850
  73.         This one specifies code 033 for France and code page 850
  74.         (Multilingual).  Country codes for the US, United Kingdom,
  75.         and most other countries do not cause this problem.
  76.         THIS DOES NOT OCCUR WITH VERSION 6.01.
  77.  
  78.        The output of the FREQ command now includes the
  79.         variable name when tables are suppressed with /N.  FREQ
  80.         now produces correct statistics when multiple variables
  81.         are specified.
  82.        A runtime error when calculating Chi Square with more than 40
  83.         degrees of freedom has been corrected.
  84.        An error message now appears if a .PGM attempts to erase a
  85.         current data set.
  86.        An error message appears when there is an attempt to add a command
  87.         (with CMD) when a command with the same name already exists.
  88.         This error is not critical and is only displayed on the screen
  89.         for informational purposes.
  90.        A check has been added to prevent reading a file
  91.         containing variables by the same name as an existing GLOBAL
  92.         variable.  If an error message signifies that this is the
  93.         case, the .PGM should be revised, either changing the
  94.         name of the DEFINEd variable involved or, if appropriate,
  95.         making it a standard or CUMULATIVE variable rather than a
  96.         GLOBAL variable.
  97.        A literal question mark can be included in a command by preceding
  98.         it with a backslash (\?).  Previously any question mark was
  99.         interpreted as part of an input command (?   ?).
  100.         For example,   IMMEDIATE SELECT VANILLA = "\?"
  101.         will select records in which the value "?" is in the
  102.         record for VANILLA.  (ENTER, however, will not accept
  103.         a "?" as the first character in an input field, so this
  104.         is not a good code for "unknown." We recommend using
  105.         the standard blank field provided by Epi Info as the
  106.         unknown or missing value, or coding unknown as "9"
  107.         or some other unused character.)
  108.  
  109.         Other escaped characters may be used in the
  110.         "Get-Input command"  (?Message to User?) (see manual page 545).
  111.         These escaped characters are:
  112.         \N        insert a carriage return and line feed in the message.
  113.         \R        insert a carriage return in the message.
  114.         \?        insert a question mark in the message.
  115.         \\        insert a backslash in the message.
  116.         IMMEDIATE LET YR = ?Enter year\?\N  will print
  117.            Enter year?
  118.         and the cursor will be placed at the beginning of the following
  119.         line.
  120.  
  121.    5. IMPORT no longer checks the length of lines being imported in fixed
  122.         length, ASCII format, ignoring characters which may be in a record
  123.         beyond the position of the record length given in the .REC file.
  124.         This allows importing data such as:
  125.              CORERECORD--
  126.              CORERECORD--EXTRA DATA
  127.              CORERECORD--
  128.         into a .REC file that specifies the format for CORERECORD--
  129.  
  130.     6. The hypertext compiler (HYPER.EXE) and the hypertext
  131.         viewer in the menus (EPI6.EXE), will now support topic
  132.         names containing spaces, as in .TOPIC DeKalb County
  133.  
  134.     7. A number of changes have been made to accommodate use from a
  135.        Local Area Network.  If tutorials or examples are run from
  136.        the main menu while logged into an inappropriate directory
  137.        a message now suggests using the SETUP function on the TUTORIAL
  138.        or EXAMPLE menu. Depending upon circumstances, this either
  139.        changes the logged directory to \EPI6 or offers to copy needed
  140.        files from a read-only directory on the LAN so that Tutorials and
  141.        Examples will run easily.  See INFORMATION FOR LAN ADMINISTRATORS
  142.        below if you will be installing Epi Info for use on a LAN.
  143.  
  144. Version 6.01 was to be released August 22, 1994.
  145. It is identified on the Internet by filenames containing EPI601_
  146. rather than EPI600_.  It is recommended that all users upgrade to
  147. the new version, particularly if they are having problems running
  148. Epi Info on a network, work with files larger than 524,288
  149. records, or use a DOS codepage or COUNTRY code other than the
  150. ones for English characters.
  151.  
  152.  
  153.                      GENERAL INFORMATION
  154.  
  155. Version 6.00 released     May 27, 1994
  156. Version 6.01 released     August 22, 1994
  157.  
  158.  
  159. Epi Info, a series of computer programs produced by CDC and the
  160. World Health Organization provides public-domain software for
  161. word processing, database and statistics work in public health.
  162. Version 6 of Epi Info was released in May, 1994, and is
  163. available from the source listed below and via the Internet.
  164. There are more than 40,000 documented copies of Version 5 of Epi
  165. Info in 117 countries.
  166.  
  167. Epi Info is a complete system for word processing, data entry,
  168. database management, and public health statistics for
  169.  
  170. IBM-compatible microcomputers (DOS). Facilities are provided for
  171. importing and exporting a variety of file types.  Although Epi
  172. Info has its own file format, dBASE files also can be
  173. analyzed directly.  The entire system occupies about 8.9
  174. megabytes with all tutorials, examples, and utilities, but the
  175. main programs occupy a total of about three megabytes.
  176.  
  177. Version 6 features a configurable pull-down menu, facilities for
  178. producing and using hypertext (active text), additional
  179. statistics, and many programming improvements.  Like previous
  180. versions, it runs on IBM-compatible computers under DOS, and
  181. requires only 640 K of memory (RAM), although a hard disk is
  182. recommended.
  183.  
  184. The entire 600-page manual (except for one chapter of
  185. statistical background for complex sample designs) is included
  186. in hypertext format on the disks and is also available in printed
  187. form.  CDC employees may obtain Epi Info and a companion program
  188. for geographic mapping (Epi Map) from the CDC Warehouse.  Readers
  189. outside CDC may obtain copies of these programs in English or of
  190. Epi Info, Version 5, in Spanish from:
  191.  
  192.                  USD, Inc.
  193.                  2075A West Park Place
  194.                  Stone Mountain, GA  30087  U.S.A.
  195.                      (404) 469-4098
  196.                  FAX (404) 469-0681
  197.  
  198. The Epi Info, Version 6, programs and manual are $50 (U.S., $65
  199. outside the U.S.), including shipping.  Epi Map and the Spanish
  200. version of Epi Info 5 are each $38 (U.S., $48 outside the U.S.).
  201. The programs and manuals may be freely reproduced, translated, or
  202. given to others.
  203.  
  204.  
  205.                       INTERNET INFORMATION
  206.  
  207. Epi Info and Epi Map are available on the worldwide Internet
  208. using the following access information:
  209.  
  210.      Site: ftp.cdc.gov   UserID: anonymous
  211.      Directory for Epi Info: /pub/epi/epiinfo
  212.      Directory for Epi Map:  /pub/epi/epimap
  213.      The compressed files occupy 3-4 megabytes for each product.
  214.  
  215. Files:
  216.      EPI601_1.EXE  About 1.2 megabytes
  217.      EPI601_2.EXE  About 1.4 megabytes
  218.      EPI601_3.EXE  About 1 megabyte
  219.  
  220. These files are self-extracting archives. Obtain them via FTP in
  221. BINARY MODE, placing them in a directory from which you will
  222. install Epi Info (e.g.\EIINSTALL; do NOT use \EPI6). Execute all
  223. three programs in this directory, which will produce a series of
  224. compressed files and INSTALL.EXE.  Run INSTALL to install Epi
  225. Info, using the (I)nstall option.  Directories called \EPI6 and
  226. \NETSS will be created and Epi Info files will be decompressed
  227. and installed. The installation files may be kept for further
  228. installations (on diskettes or on a LAN) or deleted.
  229.  
  230. To create a set of diskettes of any size or density, format the
  231. equivalent of three 1.44 megabyte diskettes, and run INSTALL
  232. using the (C)opy option.  This will place the appropriate number
  233. of compressed files on the diskettes and prompt you to insert
  234. each as needed.
  235.  
  236.          DISK SPACE AND INSTALLATION OF EPI INFO 6
  237.             (Making your own Epi Info LITE)
  238.  
  239. Version 5 of Epi Info consumed about 2.2 megabytes of disk space.
  240. Version 6 is a much larger system, occupying 7.2 megabytes for the
  241. main files, examples, and manual, with an additional 1.7 megabytes
  242. for the surveillance system example that is included.
  243.  
  244. Version 6, like previous versions, is modular, and individual parts
  245. may be loaded and used separately.  For those wishing to load parts
  246. occupying minimal disk space, the following notes may be helpful:
  247.  
  248.    The minimal function of data entry only can be supported by
  249.    loading only the ENTER.EXE and ENTER.OVR files -- 273 K
  250.    with a suitable .REC and .CHK files for data entry,
  251.    as used in door-to-door interviewing with a laptop
  252.    computer, for example.
  253.  
  254.    EPED, ENTER, and CHECK together form a skeletal system for
  255.    creating and editing questionnaires and setting up data
  256.    entry, occupying 697 K. The ANALYSIS program with its .HLP
  257.    file adds another 457 K, making a very useful core system
  258.    in 1.2 megabytes.
  259.  
  260.    Adding EPITABLE, IMPORT, EXPORT, MERGE, VALIDATE, STATCALC,
  261.    the EPI6 menu, and a number of examples increases the total
  262.    size to 3.5 megabytes.
  263.  
  264.    Adding specialized functions for nutritional anthropometry,
  265.    including EPINUT, and a demonstration program for making
  266.    menus called EPIGLUE brings to total size to 5.1 megabytes.
  267.  
  268.    If all the .BGI drivers for printing graphs from ANALYSIS
  269.    to different printers and file formats are loaded, they
  270.    occupy another 654 K.
  271.  
  272.    The entire Epi Info 6 manual of 600 pages, when loaded,
  273.    occupies 1.15 megabytes.
  274.  
  275.    The surveillance system example (NETSS) is 1.7 megabytes.
  276.  
  277.    The total size of the \EPI6 directory, if every option is
  278.    loaded, is 7.2 megabytes.  With the \NETSS directory, the
  279.    entire system occupies 8.9 megabytes of hard disk space.
  280.  
  281.    Remember, however, that most individual programs can still
  282.    be run from 360 K floppy disks if necessary.
  283.  
  284.  
  285.                 INFORMATION FOR LAN ADMINISTRATORS
  286.  
  287. The main programs in Epi Info are LAN compatible.  ENTER allows
  288. multiple users to enter data in the same file, using record-
  289. locking techniques that work through DOS and are not LAN
  290. specific.  ANALYSIS in Version 6.01 allows several users to read
  291. the same file and give appropriate messages when trying to write
  292. files if this is not permitted.
  293.  
  294. Epi Info may be installed on Local Area Networks (LAN's) in
  295. several different configurations, depending upon the intended
  296. use:
  297.    1.  The compressed installable system, containing INSTALL.EXE
  298.        and FILES1.EXE, FILES2.EXE, etc. may be placed in a LAN
  299.        directory to allow users to install the system on their
  300.        hard disks (using the (I)nstall option in INSTALL) or
  301.        copy it to floppy disks (using the (C)opy option) for
  302.        distribution to others or installation on a laptop
  303.        computer.
  304.  
  305.    2.  The executable version of Epi Info may be installed
  306.        in a LAN directory in a directory for which most users
  307.        do not have write privileges.  It is important to use
  308.        the INSTALL.BAT program to install the system.  The
  309.        main programs and examples will be installed in a
  310.        directory called \EPI6, which may be made read-only to
  311.        most users.  Users should then run the system from
  312.        another directory in which they DO have write privileges,
  313.        either another LAN directory or their local hard
  314.        disk drive.  If the sample surveillance system is
  315.        chosen during installation, a directory called \NETSS
  316.        is also created. This directory MUST BE WRITABLE for
  317.        users, or provision must be made to copy its contents
  318.        to another directory for individual use.
  319.  
  320.    3.  To install Epi Info in subdirectories that are not
  321.        directly subordinate to the root directory (e.g., in
  322.        N:\APPS\EPI6 and N:\APPS\NETSS), use the batch file
  323.        INSTALL.BAT for instructions, or merely log into the
  324.        parent directory (N:\APPS) and proceed with installation
  325.        using INSTALL6.EXE.  The desired directories will be
  326.        created subordinate to the currently logged directory
  327.        on the DESTINATION drive.  To allow Epi Info to run
  328.        properly with directories not directly off the root,
  329.        a DOS ENVIRONMENT VARIABLE called EIDIR must be set
  330.        to tell Epi Info where to find its directories.  In
  331.        this case SET EIDIR=N:\APPS will do the job.  See
  332.        the SAMPLE below.
  333.  
  334.    4.  It is possible for a user to install and run
  335.        Epi Info in a writable directory on the LAN without help
  336.        from the LAN administrator, although others having access
  337.        to the same directory can then alter the files.
  338.  
  339.                             LAN NOTES
  340.  
  341. Some tutorials and examples require write privileges. Epi Info
  342. programs need to write configuration files or save data files,
  343. and this cannot be done in a directory for which the user does
  344. not have read/write privileges. Although the system may reside in
  345. a directory for which the user does not have write privileges,
  346. the user must run it from a writable directory, either on the LAN
  347.  
  348. (if users are to share a single data file, for example), or on
  349. the user's local hard disk.
  350.  
  351. If tutorials or examples are run from the main menu while DOS is
  352. logged to an inappropriate directory a message now suggests using
  353. the SETUP function in the TUTORIAL or EXAMPLE menu. Depending
  354. upon circumstances, this either changes the logged directory to
  355. \EPI6 or offers to copy needed files from a read-only directory
  356. on the LAN so that Tutorials and Examples will run easily.
  357.  
  358. The PATH statement in AUTOEXEC.BAT must contain the location of
  359. the Epi6 directory on the LAN.  This allows Epi Info to be run
  360. from the LAN without being on the user's hard disk, although the
  361. latter is also a reasonable option if there is disk space
  362. available.
  363.  
  364. The programs should run faster if the system is copied to the
  365. user's own hard disk and run from there (perhaps accessing a
  366. common data file on the LAN).  Programs residing only on the LAN
  367. must be loaded into RAM on the user's computer via the LAN, and
  368. this can slow things down in some cases.
  369.  
  370.  
  371.                 SAMPLE (Novell) LAN INSTALLATION
  372.  
  373. In a Novell LAN, a batch file is placed in a directory called
  374. M:\BATCH that is accessed when a user types EI6; the batch file
  375. contains the following commands:
  376.  
  377. @echo off
  378. cls
  379. set eidir=n:\apps                 (Set an environment variable
  380.                                    to tell Epi Info the parent
  381.                                    directory for \EPI6 and \NETSS)
  382. map ins s6:=sys:/apps/epi6        (Set up mappings)
  383. map ins s7:=sys:/apps/netss
  384. call m:home.bat                   (Be sure that the user is running
  385.                                    system from a directory with
  386.                                    write privileges)
  387. call n:\apps\epi6\epi6.exe        (Run Epi Info)
  388. map del s7:                       (Remove the mappings)
  389. map del s6:
  390. call m:home.bat                   (Go back to home)
  391. set eidir=                        (Erase the environment variable)
  392. echo on
  393.  
  394. Although other LAN's may have different configurations or
  395. commands, perhaps this example will be helpful in setting up a
  396. smooth system for accessing Epi Info.
  397.  
  398. To run the sample surveillance system contained in the NETSS
  399. directory the user must be logged into the NETSS directory, and
  400. must have write privileges.  There are several choices in setting
  401. up NETSS on a LAN.  Here is one solution:
  402.  
  403. In the menu configuration file EPI6.MNU, in the DONETSS block,
  404. delete 'REM' from the front of lines 5, 6, and 8, making
  405. appropriate changes as needed; then add 'REM' to the front of
  406. lines 3, 4, and 9. The commands are the same as for DOS batch
  407. files.  Line numbers are for this discussion only and are not in
  408. the file.
  409.  
  410. 1  DoNETSS
  411. 2  BEGIN
  412. 3    cd %EIDIR%\NETSS
  413. 4    IF NOT EXIST NETSS.MNU GOTO NONETSS
  414. 5  REM   n:
  415. 6  REM  cd \apps\netss
  416. 7    NETSS
  417. 8  REM  call home
  418. 9    cd %EIDIR%\EPI6
  419. 10    GOTO END
  420. 11    :NONETSS
  421. 12     ECHO Could not locate %EIDIR%\NETSS\NETSS.MNU menu file for NETSS.
  422. 13     ECHO Was it installed?
  423. 14     ECHO If you are running on a LAN see README.EI6
  424. 15     ECHO NETSS must be run from NETSS directory
  425. 16     PAUSE
  426. 17    :END
  427. 18 End
  428.  
  429.  
  430.  
  431.                PRINTING THE ELECTRONIC MANUAL
  432.  
  433. The entire 600-page manual is accessible in electronic form
  434. through the MANUAL portion of the menu.  If you do not have a
  435. printed copy (highly recommended for convenience and bedtime
  436. reading), it is possible to send the electronic manual either to
  437. a printer or to a disk file in text format, using the facilities
  438. on the menu.
  439.  
  440. You will find that the manual is divided into three files, each
  441. of which must be printed separately.  The three files contain the
  442. following sections:
  443.  
  444.         A. Title Page (p. 1) - Chapter 15;
  445.         B. Chapter 16 (p. 191) - Chapter 32; and
  446.         C. Chapter 33 (p. 415) - Alphabetic Index.
  447.  
  448. To print any file, do the following:
  449.  
  450.         1. Choose MANUAL and then CONTENTS from the EPI6 main menu;
  451.         2. Choose any chapter in A - C above; press <Enter>;
  452.         3. Press <Esc> ("Software Binder" should be at top of screen);
  453.         4. Press <F5> to print this section (A, B, or C) of the manual;
  454.         5. Be patient!  The printing will take some time.
  455.  
  456. When printing, be sure to give the correct initial page number for the
  457. section you are printing so that the numbers printed at the bottom of
  458. each page will correspond to those for the printed and electronic manuals.
  459. Page numbers are available by choosing MANUAL and then CONTENTS from
  460. the EPI6 main menu.
  461.  
  462. The printed manual contains figures showing major screens and is
  463. well formatted.  It can be obtained from:
  464.  
  465.             USD, Inc.
  466.             2075A West Park Place
  467.             Stone Mountain, GA  30087  USA
  468.             (404) 469-4098
  469.             FAX   469-0681
  470.  
  471. or by photocopying a printed version.
  472.  
  473.  
  474.              UPDATES FOR VERSION 6.00  July 7, 1994
  475.  
  476. MOVING AROUND IN A HYPERTEXT VIEWER
  477.  
  478.   The following keys are used:
  479.  
  480.    <Up>, <Down>, <Tab>, or <Shift-Tab> to move cursor to keywords
  481.    <Page Up>, <Page Down> to scroll vertically one line at a time
  482.    <Ctrl-Page up>, <Ctrl-Page down>, to scroll vertically one screen
  483.  
  484.  
  485. MOVING THE CURSOR WITHOUT A MOUSE IN PROGRAMS THAT USE A MOUSE
  486.  
  487.   Several programs (IMPORT, EXPORT, CSAMPLE, VALIDATE, MERGE, and
  488. the menus, are able to use a mouse.  If you do not have a mouse,
  489. the <TAB> and (SHIFT-TAB> keys are used to move the cursor from
  490. field to field.  This feature was not used in Version 5 of Epi
  491. Info, but is consistent with modern conventions for Windows and
  492. (should you ever use a Mac without a mouse) the Macintosh.  If
  493. you have trouble moving around, therefore, try <Tab> or
  494. <Shift-Tab>.
  495.  
  496.  
  497. MATCH COMMAND
  498.  
  499. The MATCHED external command mentioned in the manual has been
  500. integrated into ANALYSIS.  The MATCH command will provide all the
  501. output that was formerly provided by the two commands, MATCH and
  502. MATCHED.  The syntax for MATCH as given in the reference section
  503. of the manual is incorrect with regards to the order of parameters.
  504. The order MUST be
  505.  
  506.     MATCH <ID> <OUTCOME> <EXPOSURE>
  507.  
  508. for meaningful results to be produced.
  509.  
  510. In order to obtain the correct results the fields should be
  511. specified in this order, as reversing the Outcome and Exposure
  512. fields will give incorrect results.
  513.  
  514. EXCLUDING FIELDS FROM A GENERAL COMMAND ("NOT")
  515.  
  516. The word NOT may be used in a LIST command, as described in the
  517. manual, to specify fields that should NOT be listed.  For
  518. example, LIST * NOT AGE SEX will list all fields EXCEPT AGE and
  519. SEX.  What is not documented in the manual, however, is that NOT
  520. can also be used with the WRITE command.
  521.   READ OSWEGO
  522.   ROUTE OSWEGO2.REC
  523.   WRITE RECFILE NOT TIMESUPP
  524.  
  525. will create a new .REC file containing all the fields from OSWEGO
  526. except AGE.  This avoids having to name many fields specifically
  527. if nearly all are to be included.
  528.  
  529.  
  530. USER INPUT WITH THE ?  ? STATEMENT
  531.  
  532. When making an assignment to a variable with the ?  ? statement,
  533. the word IMMEDIATE must be included for the assignment to take
  534. place when the input is made.  For example:
  535.  
  536.    DEFINE YEAR #### GLOBAL
  537.    IMMEDIATE YEAR = ? Year to process: ?
  538.  
  539. will work as expected, setting YEAR to the user's entry.  Without
  540. the IMMEDIATE, however, the assignment will not take place until
  541. a record of a file is read, even though the ?    ?  happens only
  542. once, when the statement occurs in the program.  The IMMEDIATE
  543. designation makes the assignment occur only once, at the time the
  544. user input is obtained.
  545.  
  546.  
  547. NEW FEATURES IN THE EPI6/EPIGLUE MENU SYSTEM
  548.  
  549. The following features were developed recently and are not
  550. documented in the Epi6 manual.
  551.  
  552. ■ SAVEAS
  553.  
  554.      The save as command can now be accessed from the <Ctrl-F9> key
  555.      combination. This is particularly useful when MENUEDIT is not
  556.      included in a menu definition.
  557.  
  558. ■ MACRO FILE
  559.  
  560.      A set of commands for opening text files or hypertext files can be
  561.      listed in a file with the same name as the .MNU file, and a .CMD
  562.      extension. If such a file exists, the indicated commands will be
  563.      executed when starting the program. The syntax for the commands is as
  564.      follows:
  565.  
  566.      HELPFILE=<Name of help file>
  567.      TEXTFILE=<Name of text file>
  568.      COMMAND=<Value>
  569.  
  570.      <Value> can be: CASCADE, TILE, or a number corresponding to the rank
  571.      of the menu options in the .MNU file. In EPI6.MNU, a value of 1 would
  572.      launch Eped for instance.
  573.  
  574.      This can be use to display a welcome message, or a warning after
  575.      installation, as in the NETSS example.
  576.  
  577.      There may be several commands of each type in the macro file.
  578.      They will be executed in sequential order.
  579.  
  580. ■ ROUTEFILE {<Filename>}
  581.  
  582.      A ROUTEFILE statement added in a function definition carries out
  583.      the following:
  584.        - does not erase the screen when swapping out
  585.        - displays a message "running the program ..."
  586.        - captures any DOS output and displays it in the built-in editor
  587.          upon completion
  588.        - default file name is $$OUT unless specified otherwise in the
  589.          command. If a filename is specified, it erases any existing
  590.          filenames with the same name.
  591.        - see COMPILE THE SYSTEM menu choice in the EPIGLUE example
  592.  
  593.      Example:
  594.  
  595.      DoFileList
  596.      BEGIN
  597.        ROUTEFILE
  598.        DIR *.REC
  599.      END
  600.      * Outputs in $$OUT
  601.  
  602.      DoFileList
  603.      BEGIN
  604.        ROUTEFILE DIRLIST.TXT
  605.        DIR *.REC
  606.      END
  607.      * Outputs in DIRLIST.TXT
  608.  
  609. ■ Background colors
  610.  
  611.      Ten colors can be defined for the background of a file, by using a #x
  612.      statement at the beginning of a given line. The title will alternate
  613.      the default and the alternate color for each line. Examine the EPI6.SCR
  614.      file for an example. The colors are as follows:
  615.  
  616.         #1        Default Blue on gray background
  617.         #2        Black on Gray
  618.         #3        Red on gray
  619.         #4        White on gray
  620.         #5        Green on grey
  621.         #6        Yellow on gray
  622.         #7        Dark gray on gray
  623.         #8        Dark green on gray
  624.         #9        Reverse gray on blue
  625.         #0        Blinking on a red background
  626.  
  627. ■ Switch to specify the name of the configuration file
  628.  
  629.   /CFG=<Configuration file and path>
  630.  
  631.       EPI6.EXE looks for the presence of the following directories
  632.       (in order):
  633.  
  634.               C:\EPI6
  635.               C:\
  636.               D:\ .. Z:\
  637.  
  638.       The first valid directory is assumed to host the configuration file.
  639.       If this file does not exists, it is created with default values
  640.  
  641.    EPI6 /CFG=C:\SOMEWHER\MYNAME.CFG
  642.  
  643.   will result in EPI6 attempting to locate the configuration file indicated.
  644.   If this file does not exist, the above algorithm is used. This switch is
  645.   useful when designing a system calling several menus working together. It
  646.   allows using one configuration file for all sub menus.
  647.  
  648. ■ IDPRINT
  649.  
  650.   An IDPRINT standard function was added. When specified in a MENUITEM
  651.   statement, it displays the printer setup dialog box.
  652.  
  653.   Example:
  654.   MENUITEM "Setup printer",IDPRINT
  655.  
  656. New Features in the Hypertext Compiler, HYPER
  657.  
  658. ■ Hyper compiler switches
  659.  
  660.     Two switches have been added to the hypertext compiler:
  661.  
  662.     /L: creates a file with the same name as the text file that is
  663.         compiled and a .LST extension. This file holds a list of topics
  664.         and their corresponding values. This is useful when using BRANCH
  665.         topics, for activating a topic by default.
  666.  
  667.     /N: prevents the screen from redrawing when HYPER is called from an
  668.         application. It is used mainly in conjunction with a ROUTEFILE
  669.         statement in a function block (see above).
  670.  
  671. ■ Predefined constants for TOPICs
  672.  
  673.   .TOPIC <Topicname>{=<x>}         {/NOWRAP}
  674.                     {=DEFAULT}
  675.                     {=MENU}
  676.                     {=GENERAL}
  677.                     {=MESSAGE}
  678.                     {=BATCH}
  679.                     {=BRANCH}
  680.  
  681.    <Topicname> is a name of your choice, used to define the block of the
  682.    text that will be displayed when a call is made to this <Topicname>.
  683.    In version 6.01, it may contain spaces to separate words.
  684.    The < and > here mean "Substitute your own topic name," and
  685.    are not included in the .TOPIC line.
  686.  
  687.    <x> is the optional Context number for context sensitive help.  This
  688.    should be a unique number <10000. The DEFAULT, MENU, GENERAL, MESSAGE,
  689.    BRANCH and BATCH are predefined values corresponding to the following:
  690.  
  691.    DEFAULT  Value=0. This corresponds to the default screen
  692.             appearing when no active option is highlighted.
  693.             There should be only one DEFAULT topic
  694.             in a file. Range 1-1999 is reserved for built-in options of
  695.             EPIGLUE, such as CUT and COPY.
  696.  
  697.    MENU     Value=2000, defining the lower bound of the range 2000-
  698.             4999. Indicates that subsequent topics will refer to user
  699.             defined menu options.  MENU should appear for the first menu
  700.             option. There should be only one MENU topic in a file. All
  701.             subsequent topics will be numbered incrementally, until a GENERAL
  702.             instruction is encountered.
  703.             .TOPIC MENU1=MENU is equivalent to .TOPIC menu1=2000
  704.  
  705.    GENERAL  Value=5000, defining the lower bound of the range
  706.             5000-9999. Indicates the beginning of context free help
  707.             screens in a context sensitive help file.  It will usually
  708.             follow a group of topics relating to user defined menu.
  709.             Only one GENERAL instruction is allowed in a help file.
  710.  
  711.             .TOPIC THE_REST=GENERAL is equivalent to .TOPIC THE_REST=5000
  712.  
  713.    BRANCH   Defining a value in the range 10000-11999.
  714.             A TOPIC DO_THIS=BRANCH will call the specified help file,
  715.             at the specified block. Each BRANCH topic should be given
  716.             the instruction. Up to 2000 BRANCH topics are allowed in a file.
  717.  
  718.             Example:  .TOPIC CALLCASEDEF=BRANCH
  719.                       CASEDEF.HLP,1100
  720.  
  721.             The file CASEDEF.HLP is loaded with the topic 1100 active.
  722.             You need must have attributed a specific number to this topic
  723.             by a .TOPIC CASE=1100. See topic HYPER in the EPIGLUE help
  724.             file for explanation on how to generate a list of these values
  725.             for a file.
  726.  
  727.    BATCH    Defining a value in the range 12000-13999.
  728.             A TOPIC DO_THIS=BATCH will treat the commands in the topic
  729.             definition as DOS batch commands.  It is possible to execute
  730.             an external application from a hypertext file, such as
  731.             displaying a graphic. Each BATCH topic should be given the
  732.             instruction. 2000 BATCH topics are allowed in a file.
  733.  
  734.             Example:  .TOPIC SHOWGRAPH=BATCH
  735.                       CD\HG
  736.                       HG SLIDESHOW.SHW
  737.  
  738.             Reference can be made to the %P parameters in a batch block.
  739.             Refer to the EPIGLUE.HLP file for explanations concerning
  740.             the %P parameters.
  741.  
  742.    MESSAGE  Defining a value in the range 14000-15999. This is a
  743.             reserved topic definition that will display a line of text
  744.             in a popup box, at the cursor location, without erasing the
  745.             screen.  It can appear anywhere in a help file, and can be
  746.             multiple. Each MESSAGE topic should be given the instruction.
  747.             2000 MESSAGE topics are allowed in a file.
  748.  
  749.             Example:  .TOPIC WARNING=MESSAGE
  750.                       You have selected the warning topic . . .
  751.  
  752.     {/NOWRAP}
  753.  
  754.     When /NOWRAP is specified, text wrapping is disabled for the entire
  755.     topic.
  756.  
  757.     Not more than 16000 topics can appear in a single help file. Each
  758.     topic should be less than 30 Kb in size. No error message appears if an
  759.     attempt is made to load a block larger than this, but the computer will
  760.     hang... The size of the file is virtually limited only by disk storage.
  761.  
  762. ■ Highlighted passive text
  763.  
  764.      The tilde ~ was added as an additional character for displaying
  765.      highlighted text in hypertext mode. This character does not occupy
  766.      space after compilation, and should be preferred to the
  767.      combination ASCII 169 et 170 mentioned in the manual. However, ASCII
  768.      169 and 170 are still supported.
  769.  
  770. ■ Hypertext troubleshooting
  771.  
  772.      The previous limitation of a maximum of 130 characters per lines in
  773.      a topic was extended to 255 characters. The maximum size maximum
  774.      of a topic was decreased from 40 Kb to 30 Kb.
  775.  
  776. ■ Microsoft Windows users
  777.  
  778.      A WINDOWS application can be called from a menu option or a hypertext
  779.      keyword in an EPIGLUE application. However there seems to be a memory
  780.      conflict when EMM386.EXE is used to set some of the extended memory
  781.      as expanded memory. In such case, a EMM386 error message flashes when
  782.      attempting to run the WINDOWS application. To get around this
  783.      limitation, you can either comment out the EMM386 driver in the
  784.      CONFIG.SYS file, or add a NOEEMS switch. This will prevent the
  785.      computer from mapping extended memory as expanded memory.
  786.  
  787.      Example:
  788.      DEVICE=C:\DOS\EMM386.EXE NOEMS
  789.  
  790. ■ Graphic file viewer PICEM.EXE
  791.  
  792.      EPIGLUE example is provided with a public domain graphic viewer. For
  793.      more information about this program, read the file PICEM.DOC in the
  794.      EPI6 directory
  795.  
  796. CHANGES IN NETSS
  797.  
  798. ■ MAPTITLE.EXE
  799.  
  800.      MAPTITLE is a utility program that updates the titles of maps created
  801.      in EPIMAP. It is used by the NETSS application for automated updating
  802.      of the MAP titles from within a .PGM. Refer to the PLACE.PGM file.
  803.      The syntax is as follows:
  804.  
  805.      MAPTITLE <Map file> <Text file>
  806.  
  807.      <Map file> should be a standard file created by EPIMAP when saving a
  808.      map. These files have a .MAP extension. If multiple maps are saved in
  809.      the .MAP file, only the title of the first map will be updated.
  810.  
  811.      <Text file> is an ASCII text file corresponding to the four lines
  812.      of the title that can be updated. In this text file, the following
  813.      syntax can be used:
  814.         - A blank line is not modified
  815.         - A line with a single . is erased
  816.         - A line with anything else replaces the existing one
  817.  
  818.      Example (the text in parenthesis is for comment only):
  819.      This text would replace line 1 of the original file
  820.      . (this would reset line 2 to a blank line)
  821.        (nothing here would keep line 3 as it is in the original .MAP file)
  822.      This text would replace line 4 of the original file.
  823.  
  824.              _________________________________________
  825.  
  826.      Details on the Huge-File Bug in ANALYSIS, Version 6.00
  827.  
  828. There is a bug in ANALYSIS for Version 6.00 that can give
  829. incorrect results for files with more than HALF a MILLION
  830. (524,288) RECORDS.  Most users do not work with files that big,
  831. and should not encounter the problem. We have corrected this bug
  832. and several others (data entry problems on networks being the
  833. most troublesome) and will be placing version 6.01 on the
  834. Internet within a few days.
  835.  
  836. For those interested in the mechanism of the large-file FREQ
  837. problem, it concerns a mechanism in ANALYSIS to make selection of
  838. records faster and more efficient when a file is processed more
  839. than once.  In ANALYSIS, a bit map is maintained, with one bit
  840. representing each record.  When a record is evaluated and found
  841. to meet the criteria in a SELECT command, the bit for that record
  842. is set to indicate that the record should be processed. On
  843. subsequent passes through the file (with the same SELECTion
  844. criteria) only the bit map needs to be consulted to decide
  845. whether a record is processed or not, speeding up the processing
  846. of the file if only a small number of records is selected.
  847.  
  848. The bit map is maintained in RAM, and is limited to 64 K (or
  849. 524,288 bits) in size.  Although a mechanism was provided to turn
  850. off this feature with files having more than 524,288 records, the
  851. mechanism was faulty and bits continued to be written outside of
  852. the allotted 64 K area, leading to the erratic results with FREQ
  853. that were observed.  Let me emphasize that, as far as we can
  854. tell, the problem was LIMITED TO FILES OF MORE THAN 524,288
  855. RECORDS, and is not a concern for smaller files.  There was also
  856. a glitch in FREQ when the command was followed by several field
  857. names, and this has also been corrected, but this one gave zero
  858. results that were obviously incorrect for some of the ancillary
  859. statistics, and would be considered inconvenient but not
  860. dangerous.  Doing the FREQ with a single field name gave the
  861. correct and complete results.
  862.  
  863. Many users will not be interested in so much detail, but
  864. sometimes details are better than a vague feeling of mistrust for
  865. all the statistics in Epi Info.  Although we can never guarantee
  866. that all results for all data sets are correct, the problem
  867. discovered with large files appears to be quite circumscribed and
  868. predictable, and is not present in Version 6.01.
  869.  
  870.  
  871.              ______________ End of News_______________
  872.